home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d17 / prin23.arc / PRIN23.DOC < prev    next >
Text File  |  1990-06-15  |  7KB  |  132 lines
  1. Prin version 2.3  Please upload this file, not beta versions.
  2. This is the first official release of prin. All previous versions are
  3. betas, and should be deleted from board directories. Thanks.
  4.  Copyright (C) Drake Koefoed 1990
  5.  
  6. By use of this program, you agree to hold the author free from any 
  7. liability of any kind.
  8.  
  9. Prin is called up by the command prin (filename) where (filename)
  10. is the name of a file. The name of the file as you entered
  11. it will be printed,(unless you use the n parameter), and then the file,
  12. at 60 lines per page unless you specify a page length with the l 
  13. parameter.
  14.  
  15. EXAMPLE: PRIN PRIN.DOC   Would print prin.doc at 60 lines per page and 
  16. also print the filename.  
  17. EXAMPLE: prin prin.doc n l58   Will print prin.doc at 58 lines per page
  18. without the filename at the top.
  19.  
  20. You may EXIT Prin at any time by pressing escape.
  21.  The printer will continue to
  22. print whatever is in it's own buffer, and you will be returned to the 
  23. prompt. It may seem not to be working at first, because if the printer buffer
  24. is full, dos will make me wait. As soon as the printer takes the line
  25. I'm sending, I go back and look to see if you have pressed escape
  26. before sending another line.
  27.  
  28. Prin filters out all FORMFEEDS embedded in the file, so it
  29. totally ignores the pagination of the file. This is handy when
  30. printing out shareware documents that have wierd page lengths,
  31. useless formfeeds, or no pagination at all.
  32.  
  33. Prin sends an escape @ to the printer on startup, which is a
  34. RESET to an Epson. Some printers may not understand this code, in
  35. which case they will not reset.
  36.  
  37. The other codes used are just formfeed and linefeed, with
  38. embedded formfeeds being replaced by linefeeds to prevent
  39. possible overprinting.  Prin uses DOS services, and has been
  40. tested under Desqview, with fine results. It should be the same
  41. under other MULTITASKERS.  You may find it works much better than
  42. print does in this situation, and it is NOT memory resident.
  43.  
  44. Prin is written in ASSEMBLER, so it is very small and fast. It
  45. could be optimized considerably and perhaps it will be, too, but
  46. it's a lot faster than my printers already. I have run {Commo} in
  47. one window of Desqview and prin in another with no noticable
  48. slowing of print speed on an 8mhz XT. Prin can run in a 5k window under
  49. Desqview. You will need more space if you use a batch file, also.
  50.  
  51. Prin depends on you to set the paper to the TOP OF FORM before
  52. starting. 60 lines will be printed, and then a formfeed. When the
  53. end of file is reached, another formfeed will be sent, and Prin
  54. will exit.  Hopefully, your printer does not have more than 6
  55. blank lines above the first one printed. If it does, you must use the l 
  56. parameter to specify the number of lines you can print. You may be able 
  57. to print more than 60, in which case you can use the l parameter to fill 
  58. up the page to the end.
  59.  
  60.  
  61. COMMAND LINE OPTIONS: use only lower case. uppercase will not work.  
  62. Spaces or forward slashes will have the same effect. Programmers refer 
  63. to these things as delimiters, because they mark the limits of the 
  64. filename and the command line parameters. If you use some that are not 
  65. needed, you will get a few dots on the screen after the last display. 
  66. Your printout is not affected. This is just to tell you you don't need 
  67. to type so much. There will soon be some more options. 
  68.  
  69. The n option prevents the filename from being printed. You can say prin 
  70. myfile/n, or prin myfile n. Either will stop the filename from being 
  71. printed.
  72.  
  73. The l option sets the number of lines to the number following. 
  74. For example: Prin filename l55  would cause prin to print out the file 
  75. called filename at 55 lines per page. This number must be two digits.
  76.  
  77. The p option puts page numbers on in upper right.
  78.  
  79. The m option adds a left margin of five charactors unless the line is 
  80. too long. Currently the maximum line length is 80 charactors. This will 
  81. soon be configurable, and I will add a wrap feature to keep those 
  82. misbehaving lines from printing off your paper. In the meantime, you can 
  83. only use the margin feature on normal files. I add a margin to any line 
  84. that is not longer than 75 chars. Otherwise, I print it without a 
  85. margin. This feature keeps your printout away from the area that hole 
  86. punches punch in.
  87.  
  88. MULTIPLE FILE PRINTING: You can do this with a BATCH file. You can say 
  89. prin %1 ,and dos will substitute the filename you type first. Then prin 
  90. %2 and dos will substitute the second filename you type. You can add 
  91. parameters in these commands if you like. If your batch file calls prin 
  92. with more files than there are, they are just going to get ignored 
  93. because files without names aren't going to be found.
  94. ERRCODES: On errors, I save the dos error code and return it on 
  95. termination, so you can find out what went wrong if you want. On 
  96. successful termination, I return an errcode of zero. Have fun, batch 
  97. freaks!
  98.  
  99. Not for profit use of this program is authorized with no fee, but I ask 
  100. that you make a contribution. I would consider a buck generous. I 
  101. have a theory of shareware that it ought to be cheaper than commercial 
  102. stuff because we get rid of all the middlemen. Unfortunately, the small 
  103. area of distribution and the people who won't pay may make up for that.
  104. One thing people could do is distribute the files all over the place to
  105. help programmers get their work seen. I would like that done with this
  106. program.
  107.  
  108.                       I NEED BETA TESTERS !
  109. If you print things prin is good for, I would like to have you run the 
  110. latest versions of the program. In exchange for your comments, I offer a 
  111. lifetime licence to use  all future versions. A $1.00 value, yours free 
  112. for God only knows how much of your time. It's just the sort of 
  113. ridiculous offer I would bite on, so if you're like me, let me know.
  114.  
  115. The best way to leave me a message about the program would be on :
  116.  Directory Assistance bbs  (707) 538-8710
  117.  CC&C                      (707) 584 3441 
  118.  Gravesend                 (707) 795 4939
  119.  VOR                       (707) 778 8944
  120.  Motherboard               (707) 778 8743
  121.   If you want to write and you want an answer, the least you could do is 
  122.  send a self addressed, stamped envelope, dontcha think? Oh yeah, and I 
  123.  should put my address in here just in case somebody actually wants to 
  124.  pay.
  125.  
  126. Drake Koefoed                    After Sept '90 I will be at the
  127. 8120 Tarwater road                    University of Oregon
  128. Santa Rosa, CA 95404                      Eugene Oregon
  129.  
  130. Desqview is the property of Quarterdeck. It's a great program.
  131. {Commo} is the property of Fred Brucker.  It's a greater program.
  132.